home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / graphics / font2pov.arj / FS.DOC < prev    next >
Text File  |  1993-09-14  |  12KB  |  321 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                     Manual for Fonts to Shapes (FS)
  15.                 A font conversion program for MS-Windows 3.x
  16.                             Version 1.1r1
  17.                               July 1993
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                  Copyright (c) 1993 Mark E. Peterson
  24.                          All rights reserved.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                       Epitaph BBS: 507-947-3174
  39.                       VirtualNet:  1@1507005
  40.                       GEnie:       M.PETERSON12
  41.                       CIS:         72147,2174
  42.                       Internet:    M.PETERSON12@GEnie.Geis.Com
  43.                                    72147.2174@Compuserve.Com
  44.                       US Mail:     Rt 2  PO Box 135
  45.                                    Lake Crystal, MN  56055
  46.  
  47. Description =======================================================
  48.  
  49. FS is a font conversion program. Specifically, it converts MS-Windows fonts
  50. into a format compatible with the Persistence of Vision (POV) ray tracing 
  51. program.  FS allows you virtually eliminate the drudgery of creating text
  52. in your POV scenes.
  53.  
  54. Other graphics to POV conversion programs typically convert each graphic 
  55. pixel to a cube. In contrast, FS uses a sophisticated shape analysis 
  56. algorithm to minimize the number of geometric shapes required to make up
  57. a character.  This provides two benefits, less time required to trace the
  58. character and it also makes the characters infinitely scalable.
  59.  
  60. In addition to accurate character conversion, FS supports special effects.
  61. You can use FS to create characters made of spheres, blobs, or cylinders.
  62.  
  63. FS is a versatile tool that will make an excellent addition to your ray
  64. tracing toolbox.
  65.  
  66. Limited License ===================================================
  67.  
  68. This software is made available under the shareware concept.  If you 
  69. continue to find it of use after the 30 day trial period, you are required
  70. to register it or your license to use it will expire.  
  71.  
  72. See order.doc in this archive for registration details.  After 
  73. registration, your copy is no longer shareware.  Please distribute the 
  74. shareware version of FS to any friends or online services you may desire.
  75.  
  76. Disclaimer ========================================================
  77.  
  78. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. 
  79.  
  80. BY USING THIS SOFTWARE YOU AGREE NOT TO HOLD THE AUTHOR OR ANY OF HIS
  81. AFFILIATES OR OTHER RELATED PARTIES LIABLE FOR ANY DAMAGES CAUSED DIRECTLY
  82. OR INDIRECTLY THROUGH USE OR INABILITY TO USE THIS PRODUCT.  THIS APPLIES
  83. EVEN IF I HAVE BEEN WARNED OF SUCH DAMAGES IN ADVANCE.
  84.  
  85. THIS AGREEMENT IS GOVERNED BY THE LAWS OF THE STATE OF MINNESOTA.
  86.  
  87. Trademarks/Copyrights =============================================
  88.  
  89. MS-DOS and Microsoft Windows are trademarks of Microsoft Corp.
  90. POV and Persistence of Vision are property of the POV-Team.
  91.  
  92. Installation ======================================================
  93.  
  94. Upgrade note: If you are a registered FS user and are upgrading, all you
  95. need replace in your existing installation are FS.EXE and BWCC.DLL.
  96. Replacing all the files will require you to reenter your registration 
  97. number.
  98.  
  99. The archive you received should contain the following files:
  100.  
  101. F2PVCFGW.DAT - FS configuration file.
  102. FS.EXE       - FS executable.
  103. BWCC.DLL     - FS controls library.
  104. FS.DOC       - This document.
  105. GLOBPALT.DAT - Logo palette
  106. FSLOGO.MEP   - FS Logo
  107. ORDER.DOC    - Instructions on how to register this product.
  108. FILE_ID.DIZ  - BBS long description file
  109. DESC.SDI     - BBS short description file
  110.  
  111. To install FS, merely copy/unzip the files into a convenient subdirectory
  112. on your hard disk.  All files, except the .doc files, MUST be in the same 
  113. directory for the program to function properly.
  114.  
  115. To install FS in the Windows Program Manager use the Program->New menu 
  116. items as usual. Note, be sure the working directory for FS in Windows 3.1
  117. is the same as the directory path for the executable.
  118.  
  119. Note: If you are running under Win-OS2 (Windows under OS/2). Add the switch
  120. -OS2 to the command line.  FS will NOT run under Win-OS2 without it.
  121.  
  122. FS Main Menu ======================================================
  123.  
  124. Below is the menu structure for FS:
  125.  
  126.    Font
  127.    ───┐
  128.       │
  129.   ┌───┴───────────┐
  130.   │ Text    Alt-T │
  131.   │ Select  Alt-S │
  132.   │ Texture Alt-E │
  133.   │ Convert Alt-C │
  134.   ├───────────────┤                             
  135.   │ Exit    Alt-X │
  136.   ├───────────────┤
  137.   │ About         │
  138.   │ Register      │
  139.   └───────────────┘
  140.  
  141. Menu Item                Accelerator
  142. ----------               -----------
  143. Font->Text                  Alt-T
  144.  
  145. Selecting this menu item will present you with a dialog box in which you may
  146. type a string of characters to convert.  Also within this dialog the 'All
  147. Chars' button allows you to quickly specify the complete character set, 
  148. codes 33 to 255.
  149.  
  150. When entering the string to convert you need not worry about entering 
  151. duplicates, FS only processes the unique characters in each string.
  152.  
  153. Once you have entered a string of characters, these characters are displayed
  154. in the currently selected font in the main window.
  155.  
  156. Menu Item                Accelerator
  157. ----------               -----------
  158. Font->Select                Alt-S
  159.  
  160. This selection allows you to specify the font to be used for the conversion.
  161. Selecting this item brings up a font selection dialog box.  Highlighting  
  162. different fonts in this dialog causes the font to change in the main window.
  163. To select a given font for conversion either double click on the font name 
  164. or highlight it and click the OK button.
  165.  
  166. Menu Item                Accelerator
  167. ----------               -----------
  168. Font->Texture               Alt-E
  169.  
  170. This item allows you to specify the texture block to be used with the
  171. selected font.  Selecting this item starts the notepad application with a
  172. file name based on the selected font.  For example, if you have selected 
  173. the font 'courier', notepad will be opened with the file name 'courier.ptx'.
  174. Don't alter the file name within notepad, FS will not be able to find the 
  175. texture file if the name is altered.
  176.  
  177. Within notepad enter the texture block as you would in any POV file, e.g.
  178.  
  179.       texture
  180.       {
  181.         Chrome_Texture
  182.         color Red
  183.       }
  184.  
  185. If you do not specify a texture for the selected font, the following 
  186. texture block will be used:
  187.  
  188.       texture
  189.       {
  190.         color White
  191.       }
  192.  
  193. Menu Item                Accelerator
  194. ----------               -----------
  195. Font->Convert               Alt-C
  196.  
  197. This selection initiates the conversion process with the text and font
  198. specified under the first two menu items.  The following dialog allows you
  199. to specify the type of conversion you wish to perform.
  200.  
  201.          ┌─────────────────────────────────┐
  202.          │                                 │
  203.          │  [X] Accurate    [ ] Blobs      │
  204.          │  [ ] Spheres     [ ] Cylinders  │
  205.          │                                 │
  206.          │  [ 1.00 ]  Shape Depth          │
  207.          │  [ 0.00 ]  Shape Overlap        │
  208.          │  [ 1.00 ]  Blob Strength        │
  209.          │  [ 0.60 ]  Blob Threshold       │
  210.          │                                 │
  211.          │  (OK)   (Cancel)                │
  212.          │                                 │
  213.          └─────────────────────────────────┘
  214.  
  215. Specifying accurate tells FS to produce POV source that will reproduce the 
  216. Windows font as closely as possible.  Selecting Blobs, Spheres or Cylinders
  217. will produce characters made up of different size Blobs, Spheres or 
  218. Cylinders.  
  219.  
  220. Shape depth applies only to accurate and cylinder conversions, it is the 
  221. depth of the character along the Z axis.
  222.  
  223. Shape overlap is used on all conversions except accurate.  Overlap specifies
  224. the percentage that each adjacent shape should overlap, this number may be
  225. negative to force shapes apart rather than together.
  226.  
  227. The last two entries apply only to blobs.  Blob strength is the first 
  228. number on each blob component. (See POV docs.)   Blob threshold is the 
  229. POV blob threshold (See POV docs.)
  230.  
  231. Menu Item                Accelerator
  232. ----------               -----------
  233. Font->Exit                 Alt-X
  234.  
  235. Exit FS.
  236.  
  237. Menu Item                Accelerator
  238. ----------               -----------
  239. Font->About                 None
  240.  
  241. Selecting this item displays the copyright and registration info for your
  242. copy of FS.  The about dialog also displays a logo created with FS and POV.
  243.  
  244. Menu Item                Accelerator
  245. ----------               -----------
  246. Font->Register              None
  247.  
  248. This menu item is only used when you have registered your copy of FS and 
  249. have obtained a registration number. After you have your registration 
  250. number, select this menu item and type the number into the dialog box.
  251. Your customer ID will now be shown in the about dialog in place of the text
  252. 'Unregistered', also, FS will produce POV files for 'R', 'E', and 'G'. (See
  253. application notes.)
  254.  
  255. Application Notes =================================================
  256.  
  257. Font objects generated under Win-OS2 will be smaller in size than those
  258. generated under straight Windows.  
  259.  
  260. Unregistered versions of the software will not produce valid POV files for
  261. the letters 'R', 'E', and 'G' in upper or lower case.
  262.  
  263. Conversions other than accurate work well with some fonts and not so well 
  264. with others, it is best to experiment with one or two characters before
  265. converting an entire string.
  266.  
  267. Each converted character is placed in a seperate POV source file.  Also 
  268. the shape is centered at <0 0 0> so that it may be easily rotated.  
  269.  
  270. Characters are generated 'facing' the Z axis, e.g. the face of the 
  271. character can be viewed by looking at <0 0 0> from a point on the + or - 
  272. Z axis.
  273.  
  274. Font files are named with the first five characters of the font name
  275. followed by _case,character or character code.  A courier '!' would be placed
  276. in couri033.pov while an acclamation 'A' would be placed in accla_UA.pov (UA 
  277. for upper case A)
  278.  
  279. Each character is declared in POV source form as an object.  The name of the
  280. object is the [Name of the font]_Char_[Character or Character Code].  Using
  281. the courier example above the '!' would have an object name of 
  282. Courier_Char_33 and the 'A' would have the name Courier_Char_A.
  283.  
  284. During a lengthy conversion process, you may minimize FS and do other 
  285. things.  The conversion process will continue in the background.
  286.  
  287. Fonts that contain thin filaments, tend to lose detail rather quickly when
  288. scaled with POV. For example, the Windows script font when reduced slightly
  289. or moved to a distant location tends to disappear completely.  If your 
  290. objective is to produce small characters in a scene, find a fat font.
  291.  
  292. Tip: To select individual 'high bit' characters (codes 128 to 255) for 
  293. conversion, use the character map applet that comes with Windows 3.1.
  294. Heres how:
  295.   1. Open the character map applet (normally found in the accessories group)
  296.   2. Select the character you desire and copy it.
  297.   3. Open the FS select text dialog and press shift-Ins. (The character
  298.      may appear differently than you expect in the edit box.) 
  299.   4. Close the dialog with 'Ok', the character you desire should appear 
  300.      in the main window.
  301.  
  302.  
  303. Appendix A - Accelerator Table
  304. ------------------------------
  305.  
  306. This table contains a summary of all of the FS shortcut keys and what 
  307. they do.
  308.  
  309. Alt-T   - Activate the 'text to convert' dialog.
  310. Alt-S   - Activate the 'select font' dialog.
  311. Alt-E   - Activate the notepad application to enter a texture block.
  312. Alt-C   - Start the conversion process. 
  313. Alt-F   - Font main menu item.
  314. Alt-X   - Exit FS.
  315. Alt--   - Main window control box.
  316. Alt-=   - Memory statistics (Used for debugging.)
  317. Alt-F4  - Exit FS.
  318. Alt-F6  - Change window focus.
  319. Ctrl-F4 - Kill the current window.
  320.  
  321.